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или Как к собрать фичу в 


\ 2022 АА 


О докладчике 


» Го!з$аск-разработчик 
в компании Еашр СОгоир нь 


(оптовая торговля оборудованием) 


. Разрабатываю проекты на 1 агауе! более 
5 лет 


. Интересуюсь структурированием кода в 
разных аспектах 


Ра РНРНизза 
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О чём пойдёт речь 


Типовая структура (агауе!-проекта и ее проблемы 
Пакет, собирающий фичу воедино 

Как это работает 

От структурных модулей к функциональным 
Преимущества и недостатки 

Сравнение с Шиса 


Заключение 


Проблемы типовой структуры 
[ ага\уе|-проекта 
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Что такое фича 


» Сравнительно обособленная единица 
функционала (например, раздел или 
подсистема) 


. Структурные компоненты фичи: классы, 
контроллеры, маршруты, шаблоны, 
наборы настроек 


Ра РНР Виза 
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> ЩЕ арр 
№ Боогар 
8 сопйа 
В дагаБазе 
8 рус 


# ГоЩе$ 
$фогаце 


Те$15 


> 
> 
р. 
и 
> №8 гезоигсе$ 
> 
> 
> 
> 


уепдог 
„еЧКогсопйа 
еп\у 
„епу.ехатр/е 
„днаниЬие$ 
.опоге 
„5Уес.ут! 
(? а ап 


{.} сотоозег.15оп 


> № Сопсае 

> № ЕхсерНоп$ 

> № Нерегз 

\ Ш Нер 
> №8 Сопно[ег® 
> №“ Маае\маге 
> № Кедие$5 

Кегпе|.рПр 
> ВВ Моде! 
> №8 Ргомаего 


Структура проекта 


»е Файлы разделены по типам: 
контроллеры, геацезГы, маршруты, 
шаблоны, конфигурация 
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Что со структурой не так 


\ @& Сопо|егз х/ @ гезоигсе$ 
> №8 Ач 


«2 АспунуСогигойег.рИр › м 5 
«> СаепаагСогигойег.рИр > |апа 


«> Согиго|ег.рИр И Е: 
> ЕуепСогигойег.рИр : 

> мем/5 
@> КтаСогигойег.рИр ы. 


> МатСотмгойег.рИр У № гошез 


«> ЦзегСогигойег.рНр > ар!.рЮр 


> В МОаемаге 
> № Кеачце$ 


> спаппе|.рбр 


<> 
аа: > сопзое.рр 


= Моде! ‘=> меб.рИр 
2 АсНуйу.рЮр 

> Еуепт.рПр 

» Кша.рИр 

2 Цзег.рПр 


Что со структурой не так 


. При поддержке и развитии фичи так или 
иначе затрагивается весь проект, есть 
риск что-то зацепить 


. С выделением фичи в отдельный сервис 
еще сложнее 
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Пакет, собирающий фичу 


воедино 
дагтоп1с/]агауе1-Теафиге$-агсп 
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Что легко и что сложно переместить 


Легко Сложно 
.е Контроллеры е |[Паблоны 
. Прочие классы . Маршруты 


. Конфигурация 
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Загрузка маршрутов 


/х ВоитебегутсеРгомтдег :: Боо%() */ 
$ТеафигеМате = $4115 —›Геафиге-> 0; 
ФгоифеВазе = $1115 —Теафиге- @ 


$1115— (Типсттоп и5е ($ТеафигеМате, $гоуфеВазе 
РоиТте ('ар1/'.$гоуфеВазе) 
('ар1т.'.$Реафигемате.'.') 
(‘арт’) 
($1115 


Загрузка маршрутов 


гестед ГипсЁ1оп ($+г фратн 


$Теафигемате = $41015 —Геафиге— 0; 
$Фта1пРа*В 'Геафигез/'.$ТеафигеМате; 
($рав 
фта 


( рав: $татпРатВ); 
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Загрузка маршрутов 


»е Свой Воч%ебегутсеРгоутаег на основе 
[ ага/иеГовского 


. Загружает файлы маршрутов, исходя из 
пути к директории фичи 


1А Ра РНРРзза 


ры шаблонов 


/х ЕеаТигебегутсеРго\то 015ег() х/ 
$Геафиге$[154 = С. Чеафигез. 1451 , - 
($РГеафиге$11${ аз Фа11аз — $Реафиге) + 
Арр. фа1\1а5, ГипсТоп () ие ($Реафуге) + 
ы ‚ $Геафиге(); 
}); 
фра НТо\/1е\5 'Геафиуге< ‘.ЗаЧаз 


г 


Утеи :: фа1тас, $ ранТо\1еиз) ы 


Загрузка шаблонов 


» Решается через добавление 
неймспейсов по именам фич 


е Реально это выполняет основной 
сервис-проваидер пакета — 
ЕеафигезЗегутсеРгоутаег 
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Загрузка конфигурации 


$4115 —соп1дига*10оп Веро51Тогу(); 
$соп1дРа{Н = геа\раев( 
$4115 —пате 
(Е1паег 
$соп1дРа*в $ФтЦе) { 
$Ч1гесфогу = $41015 фе, $сопТ1аРаН); 


$Р11е$5 [$91гесфогу .Базепапе ( 
фе О, 


$ Це 


Загрузка конфигурации 


. Сделана по аналогии с загрузкой 
конфигурации всего проекта, только с 
заменой директории для поиска 
настроечных файлов 


18 Ра РНРРзэа 


Базовый класс 


Загружает конфигурацию 
Загружает контейнер 
Загружает сервис-провайдеры 


«Гочка входа»: через него получаются маршруты, 
шаблоны, настройки 


Доступен в контроллерах как свойство Теа*иге, 
пробрасывается в шаблоны как переменная 


. ЗРеафиге фр нетьь 


Как это работает 


57 РНР Низза 
2022 


$ рИр аг{15ап маке :Теафиге РгоРПе 
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Создание заготовки фичи 


* Консольная команда рИр аг{ф15$ап 
паке : Теафиге 


» Из стабов создаются сервис- 
провайдеры, пустые файлы 
конфигурации, маршрутов, демо-шаблон 
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'115' = [ 
'Сафа\о9' — Реафугез\СафаТо9\Реа1 ::С1а$5, 


'№еиз' — Реафиге5\Мемс\ЕРеаТиге :: с1а55 
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Загрузка фич 


/* Реафигебегу1сеРгомт9ег :: гед15ег() х/ 
$Геафиге$1151 ('Геафуге5.1151', ; 
-|п ($Реафуге$15$% аз Ффа11а$ $Геафиге) + 
Арр фа\1аз, Гипс оп () изе ($Реафиге) + 
геи $Теафиге(); 
+); 


фраЕвТо\/1еи5 'Геафигез$/'.$а11а$ 


Р 1 
к 


/мте! у 


УТеи :. Фатфаз, $ разнТо\1еиз | 


Загрузка фич 


. Загружаются только фичи, включенные в 
общей конфигурации 


. ГеафигеЗегутсеРгоутаег привязывает 
базовые классы по алиасам в общий 
контейнер приложения 
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о 


Относительный роутинг 


Файлы маршрутов сохраняются в 
поддиректорию /гоцте$ директории фичи 


Ссылки на соответствующие маршруты 
получаются через обращения к методу 


гочи%е() базового класса 


Пример: гефигп гедтгес* ($34Р1$->Реафиге- 
>ГОЦТе ( 'Поте’')) 
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Внутренняя конфигурация 


Файлы конфигурации сохраняются в 
поддиректорию /соп{19 директории фичи 


Ссылки на соответствующие ключи 
получаются через обращения к методу 
сопт19() базового класса 


@1Р($Теафиге->соп{19( ' та1п.зНомВи%фоп')) 
<Би{Фоп> @епа1т 
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Шаблоны фичи 


. Файлы шаблонов сохраняются в 
поддиректорию /гезоицгсе$ /\у1ем$ 
директории фичи 

» Отдача шаблонов происходит через 
метод у1ем() базового класса 

. гефигп $%01$->Реафиге->\у1ем(' 11$*', 
['15етз'=>$1%ет$]); 

28 @5) РНРРозза 


Контейнер фичи 


. Фича имеет свой собственный сервис- 
контейнер, работающий аналогично 
контейнеру приложения 


. Привязка в контейнер выполняется 
через $Феафиге->Ь1па() или $Театиге- 
>$1п91етоп(), получение — через 
ЗГеафиге->такКе () 
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От структурных модулей к 
функциональным 
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Фича как функциональный модуль 


Следующий шаг — превращение фичи из 
структурного модуля в функциональный 


АРТ для внешних обращений оформляется как 
методы базового класса 


Все обращения к фиче снаружи должны идти 
через эти методы 


Это позволяет отвязать внутренности модуля от 
внешних классов и при необходимости вынести 
его в отдельный сервис 

Ра РНРРзза 


руб 1 с дет$ест1опВуТ9(1п{т $149, Фоп\ТуАст1\е = тгие) 
{ 


гетигп - : мпеп ($опТуАсетуе, ($ацегу) + 
$дуегу—аст1\е(); 
}) —>мпеге('19', $14) >Р1г${(); 
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руБ\1с деЕРгодис{ВуТ9(1п{т $149, ФопТуАсЕ1\е = тгие) 
{ 


гетугп -: мпеп (ФопТуАсттуе, ($ачегу) + 
$дуегу—>аст1\е(); 
}) —>мпеге('14', $19) —РЕ1г$е(0); 


о ви РН Визза 


$сата1о9 арр ( 'Сата\од' 
ФргодиусЕ = пилт; 
1+ ($сата\од 1п5Тапсеот 


! 


&& | 


(Фруб11са1оп—>ргодиус*_19) 


фргодисЕ = $сата\од—>чеЕРгодисВуТа ($ру6 11 са 1оп—>ргодуст_19); 
фФргодисЕ—иг1 = $сафта\од—гоцте( 'ргодуст', 
[ 'ргодусе ' =$ргодуист—19]); 
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Преимущества и недостатки 
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Преимущества 


Пакет решает задачу вынесения фичи в 
компактный фрагмент структуры проекта 


Даёт движок, загружающий правильно 
расположенные файлы + инструмент генерации 
первоначальной структуры 


Даёт возможность делать фичи модулями не 
только структурно, но и функционально 


Может внедряться постепенно, только для новых 


фич 
Ра РНРРзза 


Недостатки 


. Фичи привязываются в контейнер по 
именам и теоретически могут 
конфликтовать с другими классами 


. Некоторая «сырость» пакета, в том числе 
отсутствие подробной документации, 
генераторов отдельных файлов 
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ГеасигезАгси \<. Циса 
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Сходства 
» Собирают в одной директории файлы 
одной фичи 


. Представляют фичу (в Цис!А — сервис) 
как структурный и программный модуль 


. Позволяют включать и выключать фичи 


=о Ра РНРРзза 


Обработка 
запроса 


Генераторы 


Воздействие на 
структуру проекта 


Для чего выбирать 


ИФ) 


Различия 


ЕеакигезАгсВ Сиса 
Как в [ага\уе! Сопго!ег -> Кеавиге -—> 
ЧоБ 
Только начальная Начальная структура и 
структура отдельные компоненты 


Директория /Феафигези Затрагивает всю 

свой конфиг-файл структуру, в том числе 
директорию /арр 

Для структурирования Для новых проектов с 

новых или имеющихся прицелом на лучшие 


проектов с сохранением практики 
общего подхода 
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Заключение 
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Как установить пакет 


. сотрозег геди1тге дагтоптс/]агауе1- 
Театиге$-агсп 


° рИр аг{1$ап уепдог:ричб]1$1 -- 
ргоу14ег= 'багтоп1с\РГеатигезАгсй\ 
Ргоу1дегз\РеафигеЗегу1сеРгоу1 дег' 


. Добавить в сотрозег. ] зоп (секция 
«аифо1оа4.рзг4») строку: 


"Реафигез\\": "Теафигез/" 
д2 Ра РНРРзза 


Контакты 


. Теергат: @Дех_|оти$ 
. Канал: ПИрз:/ те/соае_\м/ау 
. Слайды: ПИр:/6Лу/5\М/КТАУс 


4.5 


Оценить доклад 
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